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Name 


intro — Introduction to machine related miscellaneous features and 
files. 


Nita Description 


This section contains information useful in maintaining the system. 
Included are descriptions of files, devices, tables and programs that 
are important in maintaining the entire system that are directly 
related to the kind of computer the system runs on. This section is 
intended for use with the 86 family of Intel CPUs, specifically 8086, 
8088, 80186, and 80286 based computers. 
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Name 


boot — XENIX boot program. 


Description 
The boot program is an interactive program used to load and exe- 
cute standalone XENIX programs. It is used primarily for loading 
and executing the XENIX kernel, but can be used for loading and 
executing any other programs that have been linked for standalone 
execution. The boot program is a required part of the XENIX 
Operating System and must be present in the root directory of the 
root file system to ensure successful loading of the XENIX kernel. 
The boot program is invoked by the system each time the computer 
is started. For diskette boot, the procedure has two stages: 
1. The boot block in sector 0 of the filesystem loads /boot. 
2. /boot executes and prompts the user. 

For fixed disk boot, the procedure has four stages: 
1. The masterboot boot block in sector 0 loads the partition boot 

block from sector 0 of the active partition (see fdisk(C)). 

2. Then, boot! is loaded from the next three tracks. 
3. bootl loads /boot. 
4. /boot executes and prompts the user. 


/boot and /xenix may lie on tracks which have mapped by badirk (M) . 


The fixed disk verison of boot is invoked if the diskette drive is 
empty and block 0 of the active partition of the fixed disk contains 
a valid bootstrap program. 


When first invoked (or after termination of a standalone program), 
boot prompts for the location of a program to load by displaying 
the message: 

XENIX System V 


Boot 


January 13, 1986 Page 1 — 


BOOT (M) BOOT (M) 


To specify the location of a program, a device and pathname must 
be given. The pathname must be the full pathname of the file con— 
taining the standalone program. You can display a list of the 
current allowable device names by typing the question mark (?). 


The format for the device and pathname is as follows: 
xx(m,o)filename 
where: 
xx=device name 
(e.g. ‘hd’ for the hard disk or ‘fd’ for diskette device) 
m =minor device number 
(e.g. 40 for the root filesystem) 
o =offset in the partition (usually 0) 


All numbers are in decimal. See the manual pages for hd(M) and 
fd(M) for minor device numbers of these devices. 


For example, to load xenix from the diskette, enter: 
fd(4,0)xenix 


If the user is also loading the boot program from the diskette, sim— 
ply press RETURN and boot defaults to the correct value. 


To load XENIX from a hard disk, enter: 

hd(40,0)xenix 
If the user is loading both the boot program and XENIX from a 
hard disk, press RETURN when the system displays the boot mes— 
sage, and boot uses the default value, “‘hd(40,0)xenix .” 
If nothing is typed after a short while, boot times out and acts as 
though a RETURN has been pressed. boot proceeds through the 
boot procedure, and init(C) is passed a- a flag. 


Kernel Configuration 


boot passes any boot string typed at the boot prompt to the kernel. 
If the user types RETURN , boot assumes a default string. 


The kernel reads the boot string and decides on which device to 


root, pipe and swap. The default action is to choose the device 
from which the kernel is loaded. 
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Additional arguments in the boot string can alter this default 
action. These arguments have the form: 


dev=xx(m,o) 


Where: 


dev = The desired system device (rootdev, pipedev, or swapdev) 
xx, m, o = same as for the boot device 


If only rootdevorswapdev is specified, then all system devices will be 
on that device, with the unspecified system devices using minor device 
numbers. 


If both rootdevandpipedev are specified, the location of swapdev 
defaults to the device last specified in the boot string. 


Setting only swapdev does not affect the defaults for the other sys— 
tem devices. 


Diagnostics 


On an error, boot displays an error mesage, then returns to its 
prompt. The following is a list of the most common messages: 


bad magic number 
The given file is not an executable program. 


can’t open <pathname> 
The supplied pathname does not correspond to an existing file, 
or the device is unknown. 


Stage 1 boot failure 
The bootstrap loader cannot find or read boot. You must 
restart the computer and supply a file system disk with boot in 
the root directory. 


not a directory 
The specified area on the device does not contain a valid XENIX 
filesystem. 


zero length diectory 
Although an otherwise valid filesystem was found, it contains a 
directory of apparently zero length. This most often occurs 
when a pre— System V XENIX filesystem (with incorrect, or 
incompatable word ordering) is in the specified area. 
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fload:read (x) =y 
An attempted read of x bytes of the file returned only y bytes. 
This is probably due to a premature end-of-file. It could also 


be caused because of a corrupted file, or incorrect word order- 
ing in the header. 


Files 


/boot 
/etc/default/autoboot 
/etc/masterboot 
/etc/hdbootl 


See Also 


autoboot(M), badtrk(M), fd(M), fdisk(M), hd(M), _ init(M), 
sulogin(M) 


Notes 


The computer tries to boot off any diskette in the drive. If the 
diskette does not contain a valid bootstrap program, errors occur. 


The boot program cannot be used to load programs that have not 
been linked for standalone execution. To create standalone pro- 
grams, the - A option of the XENIX linker (/d(CP)) and special 
standalone libraries must be used. 


Although standalone programs can operate in real or protected 
mode, they must not be large or huge model programs. Programs in 


real mode can use the input/output routines of the computer’s 
startup ROM. 
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Name 


Cmos — Displays and sets the configuration data base. 


Syntax 


cmos [ address | value | | 


Description 


The cmos command displays and/or sets the values in the CMOS 
configuration data base. This battery-powered data base stores 
configurationb information about the computer that is used at 
power up to define the system hardware configuration and to direct 
boot procedures. The data base is 64 bytes long and is reserved for 
system operation. Refer to your computer hardware manual for 
more information. 


The cmos command is typically used to alter the current hardware 
configuration when new devices are added to the system. When 
only address is given, the command displays the value at that 
address. If both address and a value are given, the command 
assigns the value to that address. If no arguments are given, the 
command displays the entire contents of the data base. 


The CMOS configuration data base may also be examined and 
modified by reading from and writing to /dev/cmos file. Because 
successful system operation depends on correct configuration infor— 
mation, the data base should be modified by experienced system 
administrators only. 


The computer manufacturer’s diagnostic diskette should be run 
before setting the CMOS data base. 


Files 
/etc/cmos 
/dev/cmos 
Notes 
Not all computers have a CMOS configuration data base. Some 
computers use switches on the main system board to configure the 


system. Refer to your computer hardware reference manual to 
determine whether you have a configuration data base. 
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Name 


console, tty[02—n] — Computer screen 


- Syntax 


#include <sys/console.h> 
ioctl(fd, cmd, buf) 

int fd, cmd; 

char *buf; 


Description 


The console and tty[02—n] device files provide character I/O 
between the system and the computer screen and keyboard. Each 
file corresponds to a separate teletype device. The number of 
device files available, n, depends upon the amount of memory in 
the computer. The system displays the number of enabled screens 
during the boot process. 


The console screens are modeled after a 25 line, 80 column ASCII 
terminal. Although the color graphics, enhanced graphics and pro- 
fessional graphics also support 40 column lines, XENIX does not. 


The console is the default device for system error messages, and is 
the only teletype device open when in single user mode and during 
the system boot sequence. 


To get to the next consecutive screen, enter Ctrl—PrtSc using the 
Ctrl key, and the PrtSc key, located below the carriage return key. 
Any active screen may be selected by entering alt-Fn, where Fn is 
one of the function keys on the far left side of the keyboard. FI1 
refers to the system console screen (/dev/console). 


The console is configurable via the mapkey(M) utilities, or at a 
lower level through ioc#l(S). 


Keyboard processing goes through two tables. The key mapping 
table maps keystrokes to either an ASCII value or a special function 
and the string table maps functions keys to ASCII strings. See 
keyboard(M). 
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Access 


fd must be a file descriptor open to the console. 
cmd can be one of: 


GIO_KEYMAP Get keyboard mapping table from kernel 
PIO_KEYMAP Put keyboard mapping table into kernel 
GIO_SCRNMAP_ Get screen mapping table from kernel 
PIO_SCRNMAP Put screen mapping table to kernel 
GIO_STRMAP. Get string key mapping table from kernel 
PIO_STRMAP Put string key mapping table to kernel 


buf must be one of the following types: keymap_t, scrnmap_t, or 
strmap_t as defined in <sys/console.h> . 


Refer to your computer hardware manual for information on scan 
codes generated by the keyboard and character ROM arrangement. 
Keyboard mapping is discussed in the XENIX Reference section 
keyboard(M). 


Screen Mapping (GIO_SCRNMAP, PIO_SCRNMAP) 


The screen mapping table maps extended ASCII (8-bit) characters 
to ROM characters. It is an array [256] of char (typedef scrnmap_t) 
and is indexed by extended ASCII values. The value of the ele- 
ments of the array are the ROM character to display. 


For example the following will change the ASCII character ‘#’ to be 
displayed as a English pound sign. 


#include <sys/console.h> change_pound() { scrnmap_t scrntab; 
/* 
* get screen mapping table of 
* standard output 
* 


if(ioctl(0, GIO_SCRNMAP, scrntab) == -1) 
{ 


perror(“screenmap read"); 
exit(—1); 


/* 156 is the ROM value of English 

* pound sign and 30 is the ASCII 

* value of ‘#’. 

a @ 

scrntab [30] = 156; 

if(ioctl(0, PIOLSCRNMAP, scrntab) == —1) 
{ 


perror("screenmap write’); 
exit(—1); 
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Notes 


ASCII characters are mapped to ROM characters via the screen 
map on a per screen basis. String key mapping is also on a per 
screen basis, but keyboard mapping is on a global basis. Only the 
super—user can use PIO.KEYMAP, otherwise the ioctl() call will 
fail with errno set to EACCES. 


ASCII characters less than 32 do not go through the screen output 
mapping and thus can not be mapped to ROM characters. 


Screen Attribute Sequences 


The following character sequences are defined by ANSI X3.64— 
1979 and may be used to control and modify the screen display. 
Each Pn is replaced by the appropriate ASCII number (decimal) to 
produce the desired effect. The last entry is for termcap(M) 
codes, and a‘“‘t” means “not applicable.” 


, Termcap 
ANSI Sequence Action Code 
ED ESC[Pn J Erases all or part cd 
(Erase in of a display. 
Display) Pn=0: erases from 

active position to 

end of display. 

Pn=1: erases from 

the beginning of 

display to active 

position. Pn=2: 

erases entire dis— 

play. 


EL ESC[Pn K Erases all or part ce 
(Erase in of a line. Pn=0: 
Line) | erases from active 
position to end of 
line. Pn=1: erases 
from beginning of 
line to active posi-— 
tion. Pn=2: erases 
entire line. 


ECH ESC [ Pn X Erases Pn charac T 


(Erase ters 
Character) 
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CBT 
(Cursor 
Backward 
Tabulation) 


SU 
(Scroll 


Up) 


SD 
(Scroll 
Down) 


CUP 
(Cursor 
Position) 


HVP 
(Horizontal 
& Vertical 
Position) 


CUU 
(Cursor Up) 


CUD 
(Cursor 
Down) 


CUF 
(Cursor 
Forward) 


CUB 
(Cursor 
Backward) 


HPA 
(Horizontal 
Position 
Absolute) 


HPR 
(Horizontal 
Position 
Relative) 
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ESC[PnZ 


ESC[PnS 


ESC[PnT 


BSC iris Pik 


ESC[P1;P2 f 


ESC[Pn A 


ESC[Pn B 


ESC[Pn C 


ESC[Pn D 


ESC[Pn ° 


ESC[Pn a 


CONSOLE (M) 


Moves active posi-— 
tion back Pn _ tab 
stops. 


Scroll screen up Pn 
lines, introducing 
new blank lines at 
bottom. 


Scrolls screen 
down Pn _iines, 
introducing new 


blank lines at top. 


Moves active posi-— 
tion to location P1 
(vertical) and P2 
(horizontal). 


Moves active posi-— 
tion to location P1 
(vertical) and P2 
(horizontal). 


Moves active posi-— 
tion up Pn number 
of lines. 


Moves active posi-— 
tion down Pn num-— 
ber of lines. 


Moves active posi-— 
tion Pn spaces to 
the night. 


Moves active posi-— 
tion Pn __ spaces 
backward. 


Moves active posi-— 
tion to column 
given by Pn. 


Moves active posi-— 
tion Pn characters 
to the right. 


bt 


sf 


sr 


cm 
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VPA 
(Vertical 
Position 
Absolute) 


VPR 
(Vertical 
Position 
Relative) 


IL 
(Insert 
Line) 


ICH 
(Insert 
Character) 


DL 
(Delete 
Line) 


DCH 
(Delete 
Character) 


CPL 
(Cursor to 
Previous 
Line) 


Graphic 
Rendition) 
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ESC[Pn d 
ESC[Pn e 


ESC[Pn L 
ESC[Pn @ 
ESC[Pn M 
ESC[Pn P 


ESC[PnF 
ESC[PnE 


ESC[0 m 


ESC[1 m 


ESC[4m 


CONSOLE (M) 


Moves active posi-— 
tion to line given 
by Pn. 


Moves active posi-— 
tion down Pn num-— 
ber of lines. 


Inserts Pn new, 
blank lines. 


Inserts Pn_ blank 
places for Pn char- 
acters. 


Deletes Pn lines. 


Deletes Pn number 
of characters. 


Moves active posi— 
tion to beginning of 
line, Pn lines up. 


Moves active posi— 
tion to beginning of 
line, Pn lines 
down. 


Resets bold, blink, 
blank, underscore, 


and reverse. 
Color: Restores 
normal selected 
colors. 


Sets bold. Color: 
Sets intensity 
(changes color to 
It_color). 


Sets underscore. 
Color: No effect. 


ic 


dl 


dc 
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ESC[5m 


ESC[7m 


ESC [10m 
ESC [11m 


ESC [12m 


CONSOLE (M) 


Sets blink. Color: 
Changes back- 
ground Ilt_color to 

color; foreground 
blinks. 


Sets reverse video. sO 
Color: Uses reverse 
selected colors. 


Select primary font. GE 


Select first alter- t 
nate font. Allows 

ASCII characters 

less than 32 to be 
displayed as ROM 
characters. 


Select second alter— GS 
nate font. Toggles 

high bit of 
extended ASCII 

code before dis-— 

playing as ROM 
characters. 


The following sequences are defined by International Organization 
for Standardization ISO DP 6429. 


ISO 


SGR 
(Select 
Graphic 
Rendition) 
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Sequence 


ESC([3Cm 


ESC[4Cm 


‘ Termcap 
Action Code 
Color: Selects fore— t 
ground color C 
Color: Selects , 
background color 
C. 
Page 6 
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0 Black 
~~ L ‘Red 
2. Green 
3 Yellow 
. 4 Blue 
Boat 5 Magenta 
6 Cyan 
7__White 
ESC[8m_ Sets blank (non- jf 
display). 
The following are additional control sequences. 
Name Sequence Action erie 
SGR ESC[{2;C1;C2 m _ Color only. Sets T 
foreground (C1) 
and background 
(C2) colors. 
SGR  ESC[7;C1;C2 m__ Reverse video. t 
Color: Sets 
foreground (C1) and 
background (C2) 
reverse video colors. 
a Cn Color 
O Black Grey 
1 Blue 9 Lt. Blue 
Z Green 10 += Lt. Green 
3 Cyan iT. -Db Cyan 
4 Red i iA, Red 
5 Magenta | 13 Lt. Magenta 
6 Brown 14 Yellow 
7___ White Lt. White 
SGR ESC[3;0 m Color only. 
Clears blink bit. 
SGE <ESC(3:i-m Color only. t 
Sets blink bit. 
SGR ESC[4m Underscores. 
Color: No effect 
a, 
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t ESC [Pn g Accesses alternate jf 
graphics set. Not 
the same as 


“sraphics mode.” 
Refer to your 
owner’s manual for 
decimal/character 
codes (Pn) and 
possible output 
characters. 


t ESC QFn’string ’ Define function f 

key Fn with string. 
String delimiters 
> and ’ may be any 
character not in 
string. Function 
keys are numbered 
0 through 9 (Fl = 
0, F2 = 1, etc.). 


A listing of the keyboard functions, codes, characters and escape 
sequences that are sent by each key, appear in the files: 


/usr/lib/keyboard/keys 


/usr/lib/keyboard/strings 
/usr/lib/console/screens 


Files 
/dev/console 
/dev/tty[02 —n] 
/usr/lib/console/screens 
/usr/lib/keyboard/keys 


/usr/lib/keyboard/strings 
See Also 


keyboard(M), termcap(M), mapkey(M), multiscreen (M), 
setcolor(C), setkey(M) 
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Name 


8087 


Syntax 


8087 
80287 


Description 


The 8087 is the INTEL math co—processor for the 8086. The 80287 
is the INTEL math co-—processor for the 80286. The kernel tests 
for the presence of an 8087 or 80287 at startup. 


If your system has an 8087 or 80287, you must turn off a switch 
main system board in order to enable 8087 interrupts. Check you 
hardware manual to determine the proper switch and setting. If 
your system does not have an 8087, or the switch is on, the kernel 
will run a set of emulator routines which are much slower. 


The C compiler available with the program development package 
generates the appropriate 8087 (or 80287) opcodes. C routines 
compiled with this compiler have run as much as 200 times as fast 
as the emulated code. In particular, the standard math library rou- 
tines run considerably faster if you have an 8087 (or 80287). — 


The overflow, division by zero, and invalid operand exceptions 
return a SIGFPE signal. This signal can be caught. The rest of the 
8087 and 80287 floating point exceptions (underflow, denormalized 
operand, and precision error) are masked. 

Notes 


The emulator returns meaningless information on divide by zero. 


There is no obvious way to tell which 8087 (or 80287) exception 
generated the SIGFPE. 
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Name 


fd — floppy devices 


Description 


The fd devices implement the XENIX interface with floppy disk 
drives. Typically, the tar(C) or dd(C) commands (q.v.) are used to 
read or write floppy disks. For instance, 


tar tvf /dev/fd0O 
tabulates the contents of the floppy disk in drive 0 (zero). 


The fd devices are block—buffered. The blocks are 512 bytes in 
size. This size is independent of the block size of the hard disk. 


The floppy devices are named /dev/fd0 and /dev/fd1 (see Notes, 
below, for more information about device naming procedure). The 
corresponding raw devices, /dev/rfd0 and /dev/rfd1, afford direct 
transmission between the floppy and the user’s read or write buffer. 
Hence, it is somewhat faster to use the raw devices. 


For information about formatting, see format(C). The minor 
device number determines what kind of physical device is attached 
to each device file (see Notes). 


Files 


/dev/fd0 
/dev/fd1 
/dev/rfd0O 
/dev/rfd1 
/dev/format0O 


Notes 


When accessing the raw floppy devices, the user’s buffer must begin 
on a word boundary. The count in a read(S), write(S), or lseek(S) 
call to a raw floppy device must be a multiple of 512 bytes. 


The devices respond to /dev/fd0 and /dev/fd1l. These names are 
actually links to devices with a naming scheme which will be 
apparent if one lists /dev. The particular drive and media confi- 
guration determines what device names are present. The fd0 and 
fd1 devices are followed by a two digit number, a letter, and a one 
digit number. The two digit number refers to the number of disk 
tracks per inch; either 48 or 96. The letter refers to whether the 
floppy is single (‘‘ss”) or double (“ds”) sided. The final number 
corresponds to the number of sectors on the floppy; This can be 
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either 8 or 9. For instance, /dev/fd048ss9 indicates a 48 track per 
inch, single sided, 9 sector floppy disk device in drive 0. 


The minor device numbers for floppy drives depend on the drive 
and media configuration. The most common are: 


48tpi 


ds/8 ds/9_ ss/8_ ss/9 | ds/15_— ds/8 


8 
9 
10 


11 


The scheme for creating minor device numbers is as follows. When 
interpreted as a binary number, each bit of the minor device 
number represents some aspect of the device/media configuration. 


For example, the minor device number for /dev/fd048ss8 is “8.” 
Interpreted as a binary number: 


00001000 


This is how each bit, or binary digit, is significant: 


Starting at the left hand column of the table above: The first digit is 
zero, thus the device is 48tpi. The next two digits mean: 


Sectors per 
Track 


The fourth column tells whether the floppy is single sided (ss — 0) 
or double sided (ds - 1). The last two signify the drive number: 
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Using this information, you can construct any minor device 
numbers you need. 


It is not advisable to format a low density (48tpi) diskette on a high 
density (96tpi) floppy drive. Low density diskettes written on a high 
density drive should be read on high density drives. They may not 
be unreadable on a low density drive. 


Use error-free floppy disks for best results on reading and writing. 
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Name 


hd — Internal fixed disk drive 


Description 


The files hd00, hd01 through hd04, hd0a, root, and swap provide 
block—buffered access to the primary hard disk. The correspond-— 
ing files for a second hard disk are listed below. 


root refers to the root file system; swap refers to the swap area; 
hd00 is the entire disk; hd01 through hd04 are the partitions. Parti— 
tion one is generally the XENIX partition. A 10 megabyte disk con— 
tains 10370 blocks of 1024 bytes each. The files access the disks via 
the system’s normal buffering mechanism and may be read and 
written without regard to physical disk records. 


The following are the names of the fixed disk partitions. Each par-— 
tition can be accessed through a block interface, for example 
/dev/hd01, or through a character (raw) interface, for example 
/dev/rhd01. 
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Device File Names for Fixed Disks 
Disk 1 Disk 2 Partition 


/dev/hd00 /dev/hd10 entire disk 
/dev/rhd00 /dev/rhd10 


/dev/hd0Ol /dev/hd11 first partition 
/dev/rhd01 /dev/rhd11 


/dev/hdQ2 /dev/hd12 second partition 
/dev/rhd02 = /dev/rhd12 


/dev/hd03. = /dev/hd13_~—‘stthird partition 
/dev/rhd03.— /dev/rhd13 


/dev/hd04 /dev/hd14 fourth partition 
/dev/rhd04 = /dev/rhd14 


/dev/hd0a /dev/hdla active partition 
/dev/rhdOa /dev/rhdla 


/dev/hd0d /dev/hdid DOS partition 
/dev/rhd0d /dev/rhdid 


/dev/usr 7 usr file system 
/dev/rusr 

/dev/root root file system 
/dev/rroot 

/dev/swap swap area 


/dev/rswap 


HD (M) 


Note that the last three file names do not exist for a second disk. 


The device file names for DOS partitions function similarly to 
/dev/hd?a . 


To access DOS partitions, specify letters such as “C:” or “D:” to 


indicate first or second partitions. 


The file /etc/default/msdos 


contains lines that assign a letter abbreviation for the DOS device 
name. Refer to dos(C). 


The following table lists the minor device numbers for possible disk 
partitions. The minor device names for the raw devices are identi-— 


cal. 
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Partition: 


hd00 
hd01 
hd0Q2 
hd03 
hd04 
hdOa 
hdQd 
root 
swa 


u (on Ist disk) 
recover 


Files 


/dev/hd0a 
/dev/rhd0a 
/dev/hd0? 
/dev/rhd0? 
/dev/hd0d 
/dev/rhdOd 


/dev/usr 
/dev/rusr 
/dev/root 
/dev/rroot 
/dev/swap 
/dev/rswap 


See Also 


HD (M) 


Minor Device Numbers 


Minor Minor 
Device Partition: Device 
Number: 


hd10 

hdil 

hd12 

hd13 

hd14 

hdla 

hdid 

u (user choice) 
ul 

u2 


/dev/hdla 
/dev/rhdla 
/dev/hd1? 
/dev/rhd1? 
/dev/hd1d 
/dev/rhd1d 


badtrk(C), divvy(C), dos(C), mkdev(C) 


Diagnostics 


The following messages may be printed on the console: 


invalid fixed disk parameter table 


and: 


Error on Fixed Disk (minor n), blkno = nnnnn, 
cmd=nnnnn, status=nnnn, 
sector = nnnnn, Cylinder/head = nnnnn 
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Possible reasons for the first error include: 


The kernel is unable to get drive specifications, such as number 
of heads, cylinders, and sectors per track, from the disk con- 
troller ROM. 

Improper configuration. 


The disk is not turned on. 


The disk is not supported. 


The second error specifies the following information: 


Notes 


blkno : The XENIX block number within the device. 
cmd : The last command sent to the disk controller. 
status : The first byte of error status from the disk controller. 


sector and Cylinder/head specify the location of a possible error. 
This information is used with badtrk(M). 


On the first disk, hd00 denotes the entire disk and is used to access 
the master boot record and partition table. For the second disk, 
hd10 denotes the entire disk and is used to access its partition 
table. Do not write to hd10 and hd0o. 
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Name 


keyboard — The console keyboard 


Syntax 
#include <sys/console.h> 
ioctl(fd, cmd, buf) 
int fd, cmd; 
char *buf; 
Description 
The keyboard is used to enter data, switch screens, and send cer- 
tain control signals to the computer. KXENIX makes use of several 
particular keys and key combinations These keys and key combina- 
tions have special names that are unique to the XENIX system, and 
may or may not correspond to the keytop labels on your keyboard. 
These keys are described later. 
When you press a key, one of the following happens: 
An ASCII value is entered 
ae A string is sent to the computer. 
A function is initiated. 
The meaning of another key, or keys, is changed. 
When a key is pressed (a keystroke), the keyboard sends a code to 
the computer, where the keyboard driver interprets the signals. 
The interpretation of key codes may be modified so that keys can 
function differently from their default actions. 
There are three special occurances, or keystrokes: 
Switch screens. 


Send signals. 


Charge the value of previous character, characters or string. 


Switching Screens (Multiscreen) 
To get to the next consecutive screen, enter Ctrl—PrtSe using the 


Ctrl key, and the PrtSe key, located below the carriage return key. 
Any active screen may be selected by entering alt-Fn, where Fn is 
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one of the function keys on the far left side of the keyboard. FI 
refers to the system console screen (/dev/console). 


Signals 


A signal affects some process or processes. Examples of signals are 
Ctrl—D (end of input, exits from shell), Ctrl—\ (quits a process), 
Ctrl—-S (stop output to the standard output device), and Ctrl-—Q 
(resume sending standard output). 


Typically, characters are mapped to signals using stty(C). Only sig- 
nals can be mapped using stty. 


Altering Values 


The actual code sent to the keyboad driver can be changed by using 
certain keys in combination. For example, the SHIFT key changes 
the ASCII values of the alphanumeric keys. Holding down the Ctrl 
key while pressing another key, sends a control code, or signal 
(Ctrl-D, Ctrl-S, Ctrl-Q, etc.). 7 


Special Keys 


To help you find the special keys, the following table shows which 
keys on a typical console correspond to XENIX system keys. In 
this table, a hyphen (—) between keys means ‘hold down the first 
key while pressing the second.’ 


XENIX Name Keytop Action 


BREAK Del Stops current action and 
returns to the shell. This key 
is also called the DELETE or 
INTERRUPT key. 


BACKSPACE (left arrow) Deletes the first character to 
the left of the cursor. 
Ctrl-D Ctrl-D Signals the end of input from 


the keyboard; also exits 
current shell. 


Ctrl-H Ctrl-H Deletes the first character to 
the left of the cursor. Also 
called the ERASE key. 


Ctrl-Q Ctrl-Q Restarts printing after it has 
been stopped with Ctrl-S. 
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Ctrl-S 


Ctrl-U 


Ctrl—-\ 


ESCAPE 


RETURN 


Fn 


Ctrl-S 


Ctrl-—U 


Ctrl-\ 


Esc 


(down-—left arrow) 


Fn 


KEYBOARD (M) 


Stops printing at the standard 
output device (does not stop 
the program). 


Deletes all characters on the 
current line. Also called the 
KILL key. 


Quits current command and 
creates a core file, if allowed. 
(Recommended for debugging 
only.) 


Special code for some pro- 
grams. For example, changes 
from insert mode to command 
mode in the vi(C) text editor. 


Terminates a command line 
and initiates an action from 
the shell. 


Function key n. F1-F12 are 
unshifted, F13—F14 are shifted 
F1-F12, F25-F36 are control 
F1-F12, and F37-F48 are 
ctrl—-shift F1-—F12. 


The remaining Fn keys (F49- 
F60) are on the on the 
number pad (unshifted). 


F49 - ’7’ 
F50 — ’8’ 
F51 - 9 
FS2 - ?-’ 
F53 -— ’¥ 
F54 - 79’ 
F55 - 76 
F56 —-— 7+’ 
B57 =P 
F58 - 72’ 
F59 — 73’ 
F50 - 70 


Keyboard Mapping (GIO_KEYMAP, PIO_KEYMAP) 


The keyboard mapping table maps the functionality of the keys. It 
is an array of [111] by [8] chars (typedef keymap_t). The table is 
indexed with the system scancode as the first dimension and the 
software state of the key press (see scan code section below). as 
the second dimension. 
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If the value in the table is 0 through 127 then it is the ASCH code 
of that key press. If the value is 128 through 255 then it is some 
special function (see <sys/console.h> ). 


For example, the following will change the ASCII value returned by 
the key press “SHIFT - a” from ‘A’ to ‘@’. 


#include <sys/console.h> change_A() { keymap_t keytab; 
/* 


* get keyboard table for the standard 
* input 
* 


if(ioctl(0, GIO_KEYMAP, keytab) == —1) 


perror(“keymap read’’); 
exit(-1); 

} 

/* 

* 30 is the scancode for the ‘a’ key 

om 

keytab[30][SHIFT] = ‘@’; 

if(ioctl(0, PIOLKEYMAP, keytab) == —1) 


perror(“‘keymap write”); 
exit(—1); 


ee 


String key mapping (GIO_STRMAP, PIO_STRMAP) 


The string mapping table is where the function keys are defined. It 
is an array of 256 bytes (typedef strmap_t) where null terminated 
strings can be put to redefine the function keys. The first null ter- 
minated string is assigned to the first string key and the second 
string to the second string key and so on. There is no limit on the 
length of any particular string as long as the whole table does not 
exceed 256 bytes, including nulls. Strings can be made null by the 
introduction of extra null characters. 


The following is a list of default function key values: 


Default Function Key Values 


Shift Ctrl Ctrl 

Key # Function function Function Sie 
unction 

a G 

1 ESC [M ESC[Y ESC [k ESC [w 

2 ESC [N ESC [Z ESC [l ESC [x 

3 ESC{O ESC [a ESC [m ESC [y 

4 ESC [P ESC [b ESC [n ESC [z 

5 ESC[Q ESC [c ESC [o ESC [@ 
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6 ESC [R ESC [d ESC [p ESC [[ 
7 ESC [S ESC |e ESC [q ESC f{\ 
8 ESC [T ESC [f ESC [r ESC [ 
9 ESC }U ESC [g ESC [s ESC 
10 ESC[V ESC [h ESC [t ESC |... 
11 ESC[W ESCfi ESC [u ESCr 
12 ESC [X ESC [j ESC [v ESC [{ 

Home ESC [H 

Up arrow ESC[A 

Page up ESC [I 


5 ESC[E 
Right arrow ESC[C 


End ESCIF 
Down arrow ESC[B 
Page down ESC[G 
Insert ESC[L 


The following program, called chstr, when invoked from the com- 
mand line as: 


chstr 0 “‘cd /usr/sys”’ 
will change function key “F1” from “ESC[E” to “cd /usr/sys’”’. 
#include <sys/console.h> | 


main(argc, argv) int argc; char *argv[]; { int keynum; char *newstr; 


if (argc != 3) 
{  printf(‘‘Usage: chstr keynum string\n”’); 
exit(1); 


} 

keynum = atoi(argv[1)); 

newstr = argv[2]; 

chstr(keynum, newstr); } /* F1 is string key #0 */ 


chstr(kn, ns) int kn; char *ns; { strmap_t strtab; char *from, *to, 
*s=strtab; int 1, oldlen, newlen, amount; 


if (ioctl(O, GIO_STRMAP, strtab) == —1) 
{  perror(“‘string table read failed’’); 
exit(1); 


t 
for(i=0; i<kn; i++) /* skip to right entry */ 
while(*s++ !=’ ’) 


oldlen = strlen(s) +1; 
newlen = strlen(ns)+ 1; 
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if (oldlen > newlen) 
{  /* push table up for shorter string */ 
from =s+oldlen; 
to = s+newlen; 
amount = STRTABLN-(s-strtab )—oldlen; 
while (--amount >= 0) 
*tot++ = *from++; 
while (to < from) 
*to++ =’ ®; /* clear extra 
table with NULL */ 


if (oldlen < newlen) 
{  /* push table down for longer string */ 
from = strtab+(STRTABLN-1)-—(newlen-oldlen); 
to =strtab+(STRTABLN-1); 
amount = STRTABLN-(s-strtab )—newlen; 
while(-—amount >= 0) 
*to—-— = *from-——; 


while( (*s++ = *ns++) !=’ ’) 
if (ioctl(0, PIO_STRMAP, strtab) == —1) 


{  perror(“string table write failed’’); 
exit(1); 


Scan Codes 


The following table is the default contents’ of 
/usr/lib/keyboard/keys. The column headings are: 


SCAN CODE is the scan code generated by the keyboard 
hardware when a key is pressed. 
There is no user access to the scan code generated by releasing a key. 


BASE is the normal value of a key press. 


SHIFT is the value of a key press when the SHIFT 
is also being held down. 


The other columns are the values of key presses when the CTRL, 
ALT and SHIFT keys are also held down. 


All values greater than or equal to octal \200 are special key func-— 
tions. All others are ASCII character values. 


Special key functions are listed after the keyboard table. 
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SCAN 
CODE BASE 
0 \377 
1 "\033’ 
ys 0 
3 fg 
4 fs 
5 4’ 
6 ey 
7 6” 
8 Fs 
9 8” 
10 »Q? 
11 0’ 
12 + SO 
13 Pean™ 
14 \b’ 
15 "\t’ 
16 cig 
17 Ww? 
18 *e’ 
19 é 
20 dy 
21 *y’ 
22 W’ 
23 ‘i 
24 0’ 
25 ey 
26 ‘i 
fe; at 
28 *\y? 
29 201’ 
30 »a’ 
31 1s? 
32 ‘a: 
33 4% 
34 ‘4 
eis "h’ 
36 i 
37 *k’ 
38 if 
39 2 
40 9393 
41 369 
42 \203’ 
43 me 
44 "Z 
45 "< 
46 c 
47 y’ 
48 ‘b 
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SHIFT CNTRL 


\377 
Bikey 


a? 


ad a 
\201’ 


“*\203" 
>| 


7? 
>? 
1 Ox 
Vv? 
BR? 


TT’ 
\377 
\377 
”\000” 
Bere 
277" 
NTT: 
\036’ 
\3TT’ 
BIT 
\377’ 
STF 
\037’ 
0 
a 8 be 
STF 
\021’ 
\027’ 
”\005’ 
\022’ 
\024’ 


A03V’ 


"\025’ 
“At? 
OTT 
\020’ 
\033’ 
\0335’ 
\n’ 
\201’ 
\001’ 
\023? 
"\004’ 
\006’ 
”\007’ 
\b’ 
*"\ 057 
\013’ 


CNTRL 
SHIFT 
SLT 
\377’ 


> eee 


Nee 
\377 
pS gs 
"NOTE? 
NSIT’ 
ALE 
SET 
ASL 
"ST 
\377’ 
tT" 
SER?” 
aT’ 
ig 6 i 
NST’ 
ioe ES 
NSIT 
VI)’ 
STL 
\377’ 
BE? 2 
\377 
\377 
Naa 
\377 
\n? 
\201’ 
\3TT’ 
NTT’ 
AST: 
NST? 
NTT’ 
NST?’ 
a a 
NST 
\377 
i 
\STT’ 
BIT’ 
\203 
\034’ 
sir 
ge es 
\IF 
\STT 
\377’ 


ALT 


Fo 
"\033? 
wy he 
8 
gh 
a 
76’ 
6’ 
— 
fog 
>? 
»()’ 
\b’ 
i 


\201’ 


\203” 
7? 


KEYBOARD (M) 


ALT 
SHIFT 
NOEL 
\033? 

? 1? 
"@’ 
fs 

og 


oy 


\b ? 
\207’ 


\201’ 


\203’ 


ALT 


CNTRL 


‘ar 
\TF 
\377 
”\000” 
\ata 
i i 
\37F 
"\036’ 
\STT 
\377 
OEE 
\377 
”\037’ 
NBT?’ 
\177 
AI?’ 
"\021’ 
"\027’ 
”\005’ 
"\022’ 
"\024’ 
"\031’ 
"\025’ 
"a? 
\017’ 
"\020’ 
”\033? 
”\035’ 
\n? 
*\201’ 
”\001’ 
”\023? 
"\004’ 
”\006’ 
”\007? 
\b’ 
hae 
\013’ 
*\ <2 
\377’ 
\377 
Bey 
*\203’ 
"\034 
"\032’ 
”\030’ 
”\003’ 
\026’ 
\002’ 


ALT 
CNTRL 
SHIFT 


‘oat 
\377’ 
\377 
oF 
\377 
a ei 
\377 
"aa 
iP i 
N\3TT’ 
\377 
SIT 
"\aTT’ 
\377’ 
IF 
\377 
\3T?’ 
NTT 
ok te i 
\377’ 
\377’ 
"STF" 
\377 
err ie 
NSIT’ 
AST 
\377 
\377 
Ay? 
\201’ 
arr 
a 
se 
SIT’ 
NSIT 
NST 
ip 
\S7T° 
\377’ 
eb 
\377 
sae 
”\203 
"\034’ 
TT’ 
\377’ 
gk ry 
\377’ 
\377’ 
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>)? 
”\200’ 
ae? 


\204’ 


\202’ 
\300 
\301’ 
\302’ 
\303’ 
\304’ 
\305’ 
"\306’ 
\307’ 
”\310 
\311’ 
”\205’ 
\206’ 
\360’ 
\361’ 
\362’ 
\363’ 
\364’ 
\365’ 
\366’ 
\367? 
\370? 
\371? 
Nolo 
i Ag 
\177 
NSIT 
\3i2’ 
SIS 
as 154 
\377 
“SIT 
"OTT 
re 
\377 
gr ea 
\377’ 
AST 
\377’ 
\377’ 
Ir 
acide 
gee & 


aN 
4G 
9? 
>? 
»9? 
\200’ 
ae? 


\204’ 


\202’ 
\314’ 
ge) boy 
\316’ 
a 
"\320" 
\321’ 
\322’ 
\323’ 
\324’ 
ay 


\377 
\326’ 
gs 
IT 
ory: 
a 
AST’ 
“OTT 
IT 
\377 
Ne og 
\377 
\377’ 
\377’ 
\377’ 
Vr 
NSIT 


\016’ 
A\r’ 
NSTT 
\377 
ASTT 
”\2007 
\210’ 
\204’ 


\202? 
\330" 
\331’ 
\332? 
\333? 
\334? 
\339° 
\336" 
\337” 
‘\340” 
A341? 
\023? 
\L7? 
ad 
78 
»Q? 
“a 
ses 
6” 
74.7 
Si 
roe 
»9? 
*)’ 
\17? 
ASE 
\342’ 
\343? 
\377° 
\377 
\377 
\377 
\377 
\377 
\377° 
\377 
\377 
\377° 
\377 
\377 
\377 
\377 


he a 
NST? 
ss 
\377 
SIT 
*\200’ 
*\210’ 
\204’ 


"\202’ 
\344’ 
"\345’ 
\346’ 
\347’ 
"\350’ 
"\351’ 
Ns 
\353’ 
"\354’ 
"\oS. 


>? 
> 
9 
»/? 
”\200” 
2? 


"\204’ 


\202” 
°\220? 
\221’ 
\222’ 
‘\223” 
°\224” 
\225" 
\226” 
\227° 
\230’ 
\231? 
\205° 
‘\206” 
a oe 
7? 
>” 
gy 
se 
6” 
74.7 
at iy 
7 
3” 
>()’ 
\177 
\377 
\232” 
\233” 
\377’ 
\377° 
\377 
\377’ 
\377’ 
\377° 
\377P 
\377° 
\377 
\377° 
\377° 
\377 
\377 
\377° 
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»N’? 
»M’ 
te? 
Pg 
ar de 
”\200 


299 


\204 
\202? 
\220" 
\221’ 
\222? 
\223? 
\224” 
\225" 
\2267 
\227° 
°\230’ 
\231’ 
\205” 
\206° 
oh i 
-— 
9? 
Sg 
sg 
6” 
74.9 
8 Ing 
5 
3? 
0’ 
\LIT’ 
\377 
\232? 
\233? 
\377 
\377 
\377 
\377 
\377’ 
\377’ 
\377 
\377 
\377 
\377’ 
\377 
\377 
\377 
\377 


\016’ 
Ar’ 
\377’ 
\377 
i a 
*\200” 
”\210” 
"\204’ 


\202’ 
\220' 
\221 
\222? 
\223) 
\224 
\225 
\226 
\227 
‘\230’ 
\231 
\023 
\17T 
a 
8? 
»g? 
*4’ 
soa. 
4 i 
4.7 
nae 
“> 
2? 
ty 
\177 
\377 
\232? 
\233 
\377 
\377 
\377 
\377 
\377 
\377 
\377 
\377 
\377 
\377 
\377 
\377 
\377 
\377 


\377’ 
\Ee. 
ASTT 
\377 


\202” 
°\220" 
\221 
\222’ 
\223” 
\224" 
\225" 
‘\226” 
\227° 
°\230’ 
\231’ 
‘\023" 
\177° 
i i 
8? 
»g? 
7a" 
i 
6’ 
74.9 
"+? 
a og 
»3? 
0’ 
\177° 
\377 
\232” 
\233” 
\377’ 
\377’ 
\377° 
\377 
\377 
\377° 
\377 
\377° 
\377° 
\377° 
\377° 
\377° 
\377 
\377° 
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a se 
a 
NTT 
\377 
OTT 
iT 
ge 
oC i 
IT 
ha 
NOT?’ 


Right Shift 


WI?’ 
AST 
NOTE 
gS 
NET 
Ns i 
i 
oLt 
NOTE 
ge i 
NSIT 


OT 
Not 
BANS a a 
AST?’ 
oer 
orT 
pe 
\377’ 
ALE 
ote 
NOV 


Bs 9 2 i 
6% Fe 
NSTT 
"ra 
"VST Ee 
‘<i ee 
Ona 
\377 
\377 
ei io 
ge i 


NOTE 
ite i 
BC a 
Bos i 
Bore i 
NOE 
"OLE 
\377 
i 
SIT 
\TT 


Special Key Values 


\201 


Value 


KEYBOARD (M) 


eS if 
acs gis 
a 
NOET 
\377 
SIT 
as oe 
ob 
Vr 
oF a 
3 i 


Control 


MOET 
‘Sir 
\37T" 
28 
pee a 
ASTT 
INSTT 
Bt Fi a 
ha 
\377’ 
NTT’ 


NSTT 
‘iT 
\377 
one 
ae i 
"ore 
"ASTE 
are 
gi 
aoe 
\377 
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\202 Caps Lock \203 Left Shift 

\204 Alt \205 Num Lock 

\206 Scroll Lock \207 Back Tab 

\210 change to next screen 

\220 change to /dev/console | \221 change to /dev/tty02 

Veen change to /dev/tty03 \223 change to /dev/tty04 

\224 change to /dev/tty05 \225 change to /dev/tty06 

\226 change to /dev/tty07 \261 change to /dev/tty08 

\230 change to /dev/tty09 \231 change to /dev/tty10 

\300 string key 0 \301 string key 1 

\302 string key 2 \303 string key 3 

\304 string key 4 \305 string key 5 

\306 string key 6 \307 string key 7 

\310 string key 8 \311 string key 9 
(continues through \373: string key 59) 

\373 string key 59 oe No operation 
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Files 


/usr/lib/keyboard/keys 
/usr/lib/keyboard/strings 


See Also 
console(M), mapkey(M), multiscreen(M), setkey(C), stty(C) 
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Ip, lpO, Ip1, lp2 — Line printer device interfaces. 


Description 


The Ip, Ip0, Ip1, and Ip2 files provide access to the optional paral- 
lel ports of the computer. The Ip0 and Ip2 files provide access to 
parallel ports 1 and 2, respectively. The Ip1 file provides access to 
the parallel port on the monochrome adaptor. Only one of Ip0 and 
Ip1 may be used on a given system. To access two parallel printers 
on a system, use either Ip0 or Ip1, and Ip2. The Ip file is actually a 
link to either Ip0, Ip1 or Ip2 and is the default output file for all 
Ip(C) commands. Because the files are intended to give access to a 
standard dot matrix printer, all bytes written to a file are passed 
directly to the given port without translation. 


Files 
/dev/|p 
/dev/|p0 
/dev/Ip1 
/dev/lp2 

See Also 


Ip(C), lpadmin(C), lpsched(C), Ipinit(C) 


Notes 


The standard Ip ports, Ip0, Ip1, and Ip2 send a printer initialization 
string the first time the file is opened after the system is booted. 


Not all computers have an alternate parallel port slot. 
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Name 


Machine — Description of host machine. 


Description 


This page lists the internal characteristics of personal computers 
which use the Intel 8086 processor family and its associated 
hardware. The information is intended for software developers 
who wish to transfer relocatable object or executable files from 
other XENIX machines to a personal computer then prepare the 
files for execution on the personal computer. 


Central Processing Unit Intel 8086, 8088, 80186, 80286 
Disk Block Size (BSIZE) 1024 bytes 


Memory Management Scheme Unmapped (8086, 8088, 80186) 
Segmented (80286) 


Split Instruction and Data Supported 


Variable Stack Size Supported (8086 only) 
(8086 default configuration) 


Fixed Stack Size Supported : 
(80286 default configuration) 


Clock Ticks .05 second (8086, 8088, 80186) 
.02 second (80286) 


Binary Compatibility 


The small and middle model binary programs created by the C 
compiler ec(CP) runs on many processors. This chart shows which | 
XENIX systems running on which processors produce code execut- 
able on other machines. cc(CP) produces code by default, but can 
also be used as a cross development compiler, by using the 
appropriate flags. 


SCO-nn is XENIX distributed by The Santa Cruz Operation, Inc. 
MS-nn is XENIX distributed by Microsoft Corporation. Intel 
XENIX is distributed by Intel Corporation. Altos XENIX is distri— 
buted by Altos Computer Systems. nn designates the machine pro- 
cessor. System designates the version of XENIX, either 2.3, 3.0, or 
System V. 
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which run on 


Processor 


SCO-86 SystemV 
SCO-186 3.0 


SCO-186 System V 


SCO-286 3.0 


SCO-—286 System V 


MS-—286 3.07 


MS-—286 System V 


SCO-286 SysV 


SCO-86 Sys V 

SCO-186 Sys V 
SCO-286 Sys V 
MS-286 Sys V 


SCO-286 Sys V 


SCO-86 Sys V 
SCO-186 Sys V 
SCO-286 Sys V 
MS-286 Sys V 


SCO-86 Sys V 

SCO-186 Sys V 
SCO-286 Sys V 
MS-—286 Sys V 


MS-286 Sys V 


Binary Compatibility 


Your Default compiler 
System/ produces programs 


System/Processor 


SCO-86 [3.0, Sys V] 
SCO-186 [3.0, Sys V] 


SCO-86 [3.0, Sys V] 
SCO-186 [3.0, Sys V] 


SCO-286 [3.0, Sys V] 
MS-286 [3.0t, Sys V] 


MS-286 [3.0t, Sys V] 
SCO-286 Sys V 


SCO-286 Sys V 


Runs default Compiles (cross 
programs developemnt) 
created on programs for 


System/Processor System/Processor 


MS~-—286 3.0f 

DOS* 

SCO-186 3.0 

Intel, Altos—86 2.3, 3.0 


SCO-86 [3.0, Sys V] 
SCO-186 [3.0, Sys V] 
SCO-286 Sys V 

Intel, Altos—86 2.3, 3.0 


MS-286 3.07 
DOS* 
SCO-286 3.0 
MS~-286 3.0f 


SCO-86 [3.0, Sys V] SCO-286 3.0 
SCO-186 [3.0, Sys V] | MS-286 3.0t 
SCO-286 [3.0, Sys V] 
MS-286 [3.0¢, Sys V] 


SCO-86 3.0 
SCO-186 3.0 
Intel, Altos—86 2.3, 3.0 


SCO-86 [3.0, Sys V] 
SCO-186 [3.0, Sys V] 
SCO-286 Sys V 
Intel, Altos—86 2.3, 3.0 


SCO-86 3.0 


SCO-286 3.0 


SCO-86 [3.0, Sys V]t 
SCO-186 [3.0, Sys V]¥ 
SCO-286 [3.0, Sys V]¢ 


* MS-DOS for i8086/8088, i80186 and i80286 processors. 
+ MS-286 3.0 XENIX is equivalent to Intel 286 3.0 XENIX. 
+t untested, pending release of this product. 


See also 


clockrate(M), cc(CP), 1d(CP), a.out(F). 
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Name 


parallel — Parallel interface devices. 


Description 
There are two or three parallel devices: 
/dev/lpO Main parallel adapter. 
/dev/lp1 Adapter on monochrome video card. 
/dev/lp2 Alternate parallel adapter (on appropriate machines). 


/dev/\p is linked to the most often used parallel adapter interface. 


Usage 


Usually invoked by through /p(C), but can be written to directly. 


Files 


/dev/lp 


See Also 


Ip(C) 
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Name 


ttyl[a—h] , ttyl[A—H] , tty2[a—h] , tty2;/A—H] - Interface to serial 
ports 


2 Description 


The ttyl[a—h], ttyl[A—H], tty2[a—h] and tty2[A—H] files provide 
access to the optional serial ports of the computer. Each file 
corresponds to one of the serial ports (with or without modem con- 
trol). Files are named according to the following conventions: 


- The first number in the file name corresponds to the COM 
expansion slot. 


— Lower case letters indicate no modem control. 
— Upper case letters indicate the line has modem control. 
For example, the default serial lines are: 


ttyla ttylA 
tty2a tty2A 


For backwards compatibility, these four are linked to tty11, tty13, 
tty12 and tty14 respectively. ttyla and tty1A both refer to COM 1, 
whereas tty2a and tty2A both refer to COM 2. 


For example, with a four port expansion board installed at COM 1 
and a single port board installed at COM 2, you can access: 


ttyla ttylA 
ttylb tty1B 
ttylc tty1C 
ttyld tty1D 


tty2a tty2A 
Each serial port has modem and non—modem invocations. The fol- 
lowing device names refer to the serial ports, with and without 


modem control. The first section of the table describes boards at 
COM 1 and the second section describes boards installed at COM 2. 
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Serial Lines 


Board Non-—-Modem 
Type Control 
Minor Name 


Modem Control 


Minor Name 


Interrupt Vectors: 


All board(s) installed at COM 1 - 4 
All board(s) installed at COM 2 5 


For a list of I/O addresses, see the Release Notes furnished with 
your distribution. 


Access 


The files may only be accessed if the corresponding serial interface 
card is installed and its jumper I/O address correctly set. Also, for 
multi-port expansion cards, you must use the mkdev(C) program to 
create more than the default number of files. See mkdev(C) in the 
XENIX Reference. 


The serial ports must also be defined in the system configuration. 
Check your hardware manual to determine how your system is 
configured, via a CMOS database or by switch settings on the main 
system board. If your system is configured using a CMOS database, 
the ports are defined in the database (see cmos(M)). Otherwise, 
define the ports by setting the proper switches on the main system 
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board. Refer to your computer hardware manual for switch set-— 
tings. It is an error to attempt to access a serial port that has not 
been installed and defined. 


The serial ports can be used for a variety of serial communication 
purposes such as connecting login terminals to the computer, 
attaching printers, or forming a serial network with other comput-— 
ers. Note that a serial port may operate at most of the standard 
XENIX baud rates, and that the ports (on most computers) have a 
DTE (Data Terminal Equipment) configuration. The following 
table defines how each pin is used. 


Pin | Description 
Transmit Data 

(6 | RequesttoSend 
[7 | Signal Ground 


re Carrier Detect (Data Set Ready) 


Data Terminal Ready 


Only pins 2, 3, and 7 are necessary for a terminal (or direct) con- 
nection. 


~ 


See tty(M) and termio(M) for the details of serial line operation in 
the XENIX system. 


Files 


/dev/tty1[a—h] 
/dev/tty1[A—-H] 
/dev/tty2[a—h] 
/dev/tty2[| A—H] 
/dev/tty11 
/dev/tty12 
/dev/tty13 
/dev/tty14 


See Also 


cmos(M), getty(M), mkdev(C), termio(M), tty(M) 
XENIX Installation Guide 
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Notes 


When using a serial line with cu(C) or uucp(C) modem control 
means that the line you log in on will be logged out when you hang 
up. Background processes may be killed. See nohup(C) and 
csh(C)). You must use a modem cable. Modem control should 
not be used for dial out situations. 


Never attempt to use a port with both modem and non-—modem 
control at the same time, or you see the warning: 


“cannot open: device busy” 


Also, you cannot use ports on the same serial card with both 
modem and non—modem control at the same time. 
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